#時間デカルト軸
タイムスケールは時刻と日付を表示するために使用されます。データは、データ ポイント間の時間量に応じて分散されます。ティックを構築する際、スケールのサイズに基づいて最も快適な単位を自動的に計算します。
#日付アダプター
時間スケール必要日付ライブラリと対応するアダプターの両方が存在する必要があります。からお選びください利用可能なアダプター (新しいウィンドウが開きます)。
#データセット
#入力データ
見るデータ構造。
#日付形式
タイム スケールのデータを提供する場合、Chart.js は内部的にエポック (UTC 1970 年 1 月 1 日午前 0 時) からのミリ秒として定義されたタイムスタンプを使用します。ただし、Chart.js は、選択した日付アダプターが受け入れるすべての形式もサポートします。設定したい場合はタイムスタンプを使用する必要があります。parsing: false
より良いパフォーマンスのために。
#構成オプション
#時間軸固有のオプション
名前空間:options.scales[scaleId]
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
min | number |string | 表示する最低限の項目。もっと... | |
max | number |string | 表示する最大項目。もっと... | |
suggestedMin | number |string | 前にデータポイントがない場合に表示される最小項目。もっと... | |
suggestedMax | number |string | 背後にデータポイントがない場合に表示する最大項目。もっと... | |
adapters.date | 45b5846d-53e8-4c86-89d2-621bbfae717f | {} | 外部日付ライブラリのアダプターのオプション (アダプターがオプションを必要とするかサポートする場合) |
bounds | string | 'data' | スケールの境界を決定します。もっと... |
offsetAfterAutoskip | boolean | false | true の場合、棒グラフのオフセットは自動スキップされた目盛りを使用して計算されます。 |
ticks.source | string | 'auto' | ダニが生成される仕組み。もっと... |
time.displayFormats | object | さまざまな時間単位をどのように表示するかを設定します。もっと... | |
time.isoWeekday | boolean |number | false | もしもboolean true で単位が「週」に設定されている場合、週の最初の日は月曜日になります。そうでなければ日曜日になります。もしもnumber 、週の最初の曜日のインデックス (0 - 日曜日、6 - 土曜日) |
time.parser | string |function | 日付のカスタムパーサー。もっと... | |
time.round | string | false | 定義されている場合、日付はこの単位の先頭に丸められます。見る時間単位許可される単位については以下を参照してください。 |
time.tooltipFormat | string | ツールチップに使用するフォーマット文字列。 | |
time.unit | string | false | 定義されている場合、ユニットは強制的に特定のタイプになります。見る時間単位詳細については、以下のセクションを参照してください。 |
time.minUnit | string | 'millisecond' | 時間単位に使用される最小の表示形式。 |
#すべてのデカルト軸に共通のオプション
名前空間:options.scales[scaleId]
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
bounds | string | 'ticks' | スケールの境界を決定します。もっと... |
position | string |object | 軸の位置。もっと... | |
stack | 4b08ca89-顔-4b1b-a99f-4d05c93eb70e | スタックグループ。同じ軸position 同じようにstack 積み重ねられています。 | |
stackWeight | number | 1 | スタックグループ内のスケールの重量。グループ内のスケールに割り当てられたスペースの量を決定するために使用されます。 |
axis | string | これはどのタイプの軸ですか。可能な値は次のとおりです。'x' 、'y' 。設定されていない場合、これは ID の最初の文字から推測されます。'x' また'y' 。 | |
offset | boolean | false | true の場合、余分なスペースが両端に追加され、グラフ領域に収まるように軸が拡大縮小されます。これは次のように設定されていますtrue デフォルトで棒グラフの場合。 |
title | object | スケールタイトル構成。もっと... |
#全軸共通オプション
名前空間:options.scales[scaleId]
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
type | string | 使用されているスケールの種類。カスタム スケールを作成し、文字列キーを使用して登録できます。これにより、グラフの軸のタイプを変更できます。 | |
alignToPixels | boolean | false | ピクセル値をデバイスのピクセルに合わせます。 |
backgroundColor | Color | スケール領域の背景色。 | |
border | object | 境界線の構成。もっと... | |
display | boolean |string | true | 軸のグローバル可視性を制御します (次の場合に表示されます)。true 、いつ隠されるかfalse )。いつdisplay: 'auto' 、軸は、少なくとも 1 つの関連データセットが表示されている場合にのみ表示されます。 |
grid | object | グリッドラインの構成。もっと... | |
min | number | ユーザー定義のスケールの最小値。データの最小値をオーバーライドします。もっと... | |
max | number | ユーザー定義のスケールの最大値。データの最大値をオーバーライドします。もっと... | |
reverse | boolean | false | スケールを逆にします。 |
stacked | boolean |string | false | データをスタックする必要があります。もっと... |
suggestedMax | number | データの最大値を計算するときに使用される調整。もっと... | |
suggestedMin | number | 最小データ値を計算するときに使用される調整。もっと... | |
ticks | object | 設定にチェックマークを付けます。もっと... | |
weight | number | 0 | 軸のソートに使用される重み。重みが大きいほど、チャート領域から遠くなります。 |
#時間単位
次の時間測定がサポートされています。名前は文字列として渡すことができます。time.unit
特定のユニットを強制するための設定オプション。
'millisecond'
'second'
'minute'
'hour'
'day'
'week'
'month'
'quarter'
'year'
たとえば、常に月ごとの単位を表示する時間スケールを持つグラフを作成するには、次の構成を使用できます。
const chart = new Chart(ctx, {
type: 'line',
data: data,
options: {
scales: {
x: {
type: 'time',
time: {
unit: 'month'
}
}
}
}
});
#表示形式
各単位のキーを使用して表示形式のマップを指定できます。
millisecond
second
minute
hour
day
week
month
quarter
year
値として使用される形式文字列は、使用することを選択した日付アダプターによって異なります。
たとえば、quarter
月と年を表示するユニットを使用するには、次の構成をチャート コンストラクターに渡すことができます。
const chart = new Chart(ctx, {
type: 'line',
data: data,
options: {
scales: {
x: {
type: 'time',
time: {
displayFormats: {
quarter: 'MMM YYYY'
}
}
}
}
}
});
#ティックソース
のticks.source
プロパティはティックの生成を制御します。
'auto'
: スケール サイズと時間オプションに基づいて「最適な」ティックを生成します'data'
: データからティックを生成します (データからのラベルを含む){x|y}
オブジェクト)'labels'
: ユーザーが指定した値からティックを生成しますlabels
それだけ
#パーサー
このプロパティが文字列として定義されている場合、日付アダプターが日付を解析するために使用するカスタム形式として解釈されます。
これが関数の場合、日付アダプターで処理できる型を返す必要があります。parse
方法。
#最小最大構成
どちらにとっても、min
とmax
プロパティの場合、値は次のようにする必要がありますstring
これは、日付アダプターで解析できるもの、または UNIX エポックから経過したミリ秒数の数値です。
以下の例では、x 軸は 2021 年 11 月 7 日に始まります。
let chart = new Chart(ctx, {
type: 'line',
data: {
datasets: [{
data: [{
x: '2021-11-06 23:39:30',
y: 50
}, {
x: '2021-11-07 01:00:28',
y: 60
}, {
x: '2021-11-07 09:00:28',
y: 20
}]
}],
},
options: {
scales: {
x: {
min: '2021-11-07 00:00:00',
}
}
}
});
#スケール タイプをタイム スケールから対数/リニア スケールに変更します。
スケール タイプをタイム スケールから対数/線形スケールに変更する場合は、以下を追加する必要があります。bounds: 'ticks'
スケールオプションに。変更するbounds
パラメータのデフォルト値は'data'
タイムスケールの場合。
初期設定:
const chart = new Chart(ctx, {
type: 'line',
data: data,
options: {
scales: {
x: {
type: 'time',
}
}
}
});
スケールの更新:
chart.options.scales.x = {
type: 'logarithmic',
bounds: 'ticks'
};
#内部データ形式
内部的な時間スケールはエポックからのミリ秒を使用します